home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 71.zip / BS1 part 71 / X-Cad3000_d5.adf / XCdoc / drawcir < prev    next >
Text File  |  1991-11-22  |  4KB  |  120 lines
  1.  
  2.    5.4.1 DRAW CIRCLE
  3.  
  4.  
  5. The DRAW CIRCLE is used to draw one or more full circles using a variety of
  6. construction techniques.
  7.  
  8.  
  9.    COMMAND FORMAT
  10.  
  11.       #DRAW CIRCLE [modifiers] :Loc x1 ... xn [:Loc x1 ... xn]    etc.
  12.  
  13. If the command is used with no modifiers, 3 locations are entered to define
  14. a circle. A circle will be constructed so that it passes through all 3 of
  15. the locations entered. ( See fig. 5.15 ).
  16.  
  17.  
  18.    MODIFIERS
  19.  
  20. LAYER       Requires a layer number. This will override the current active
  21.             layer.
  22.  
  23. DEPTH       Requires a depth number. This will override the current active
  24.             depth.
  25.  
  26. RADIUS      Requires a real value defining the radius of the circle.
  27.  
  28.             Format:
  29.  
  30.                #DRAW CIRCLE RADIUS value :Loc x1 ... xn
  31.  
  32.                   or
  33.  
  34.                #DRAW CIRCLE RADIUS :Loc x1 x2 :Loc ...
  35.  
  36.             If the RADIUS modifier is entered with a value, each location
  37.             entered will be the centre of a circle. ( See fig. 5.16 ).
  38.  
  39.             If the RADIUS modifier is entered with no value, 2 locations are
  40.             entered to define each circle. 'x1' defines the centre of the
  41.             circle, 'x2' defines the radius of the circle as the distance
  42.             between 'x2' and 'x1'. ( See fig. 5.17 ).
  43.  
  44. DIAMETER    Requires a real value defining the diameter of the circle.
  45.  
  46.             Format:
  47.  
  48.                #DRAW CIRCLE DIAMETER value :Loc x1 ... xn
  49.  
  50.                   or
  51.  
  52.                #DRAW CIRCLE DIAMETER :Loc x1 x2 :Loc ...
  53.  
  54.             If the DIAMETER modifier is entered with a value, each location
  55.             entered will be the centre of a circle. ( See fig. 5.18 ).
  56.  
  57.             If the DIAMETER modifier is used without a value, 2 locations
  58.             are required to define each circle. The centre of the circle is
  59.             calculated from the midpoint of a line drawn between 'x1' and
  60.             'x2', while the diameter is set as the distance between 'x1' and
  61.             'x2'. ( See fig. 5.19 ).
  62.  
  63. TANGENTIAL  Format:
  64.  
  65.                #DRAW CIRCLE RADIUS/DIAMETER value TANGENTIAL :Ent x1 x2 :Ent
  66.  
  67.                   or
  68.  
  69.                #DRAW CIRCLE RADIUS/DIAMETER TANGENTIAL :Ent x1 :Loc x2 :Ent 
  70.  
  71.             Will draw a circle that is tangential to 2 existing entities or
  72.             a circle tangential to one existing entity but with its centre
  73.             at a specified location.
  74.  
  75.             The existing entities may be any of cpoint, line, arc, string
  76.             or polygon. If the entity is a string or polygon, the segment
  77.             nearest the identifying location is used. ( See fig. 5.20 and
  78.             5.21 ).
  79.  
  80.             If TANGENTIAL is used with RADIUS or DIAMETER with no value, the
  81.             second location entered after one entity is identified will
  82.             become the circle centre. The radius of the circle is then
  83.             derived from the distance of the centre to the tangent point.
  84.             ( See fig. 5.22 ).
  85.  
  86.             Some cases involving a circle that is tangential to 2 entities
  87.             can have up to 8 possible solutions. The solution returned is
  88.             dependent on the locations that were used to identify the
  89.             existing entities.
  90.  
  91. PARALLEL    Format:
  92.  
  93.                #DRAW CIRCLE PARALLEL [value] :Ent x1 :Loc x2 :Ent ...
  94.  
  95.             Will draw a circle parallel to an existing circle or arc. 'x1'
  96.             identifies the existing entity.
  97.  
  98.             'x2' defines which side of the existing circle to draw the new
  99.             circle. If PARALLEL is followed by a value, this defines the
  100.             amount to add or subtract from the radius of the existing circle
  101.             to create the new circle. If PARALLEL is not followed by a
  102.             value, the new circle is constructed parallel to the existing
  103.             circle and passing through the point 'x2'. ( See fig. 5.23 ).
  104.  
  105. HARDFONT    Indicates a hardware line-style will be entered.
  106.  
  107. .STYLE      One of the predefined style, a value between 0 and 15.
  108.  
  109. .THICKNESS  Line thickness, a value between 1 and 5.
  110.  
  111. SOFTFONT    Indicates a software line-style will be entered. For a full
  112.             description of the SOFTFONT options, see the documentation for
  113.             the command DEFINE SOFTFONT.
  114.  
  115. ATTRIBUTE   Used to enter one or more attributes associated with this
  116.             entity. For a full description of the ATTRIBUTE option, see
  117.             the documentation for the command ADD ATTRIBUTE.
  118.  
  119.  
  120.